###############################################################################
#                                                                       #
# GroundProximityWarningSystem (GPWS) User Manual                       #
#                                                                       #
#   By Rob Barendregt    Release 3.2 (Fokker version)       7 may 2005  #
#                                                                       #
#########################################################################


NOTE: The description below applies to the GENERIC version of my GPWS gauge.
      So please ignore all remarks about gauge/pathnames, installation examples,
      customisation, etc. For the PF10070, the gauge is packed in a special
      .cab file, and is pre-configured !

Introduction
===========-
This freeware GroundProximityWarningSystem (GPWS) for FS2004 can be added to any
aircraft that has RETRACTABLE gear and flaps. 
It consists of three main gauges:
- GPWS3.xml, the main gauge.
  It offers the following main features:
  - Clickable switch, with Test/Inhibit function and warning light.
  - 8 different warning modes, with all the usual aural warnings, like "Pullup",
    "Sinkrate", "TerrainTerrain", "Windshear" and normal Altitude callouts.
  - All modes can be deactivated individually, or even be permanently disabled.
  - Fully customiseable per aircraft type, by just editing the gauge with Notepad.
- GPWS3_MasterWarn.xml,  which does two things: panel window switching and central
  aural warning (de-)activation for the main gauge.
  It appears as a small, clickable light that is Off, RED or Flashing.
- GPWS_Sound.gau, which "plays" the aural warnings initiated by GPWS3.xml
  This gauge is created by Doug Dawson (originally named dsd_xml_sound3.gau). 

All valid mouseclicks (i.e. causing a state change) on any of the clickspots
are confirmed by a Click sound.


The GPWS3 gauge: Detailed Functionality
=======================================
The GPWS3.xml gauge has three main states:
- Off.
  When Off (light Red), all other lights/switches are make disabled and made
  invisible. By clicking this Master switch, the gauge state becomes Test.
- Test.
  - The gauge is tested (Test state, light Green), and a testsound is played 
    (WhoopWhoopGlideslope).
  - When finished, the state is set to On (light Off)
  - The Mode switches/lights are made visible, according to their state defined
    in the parameter list in the .xml file (Default: all On).
- On.
  - The GPWS Modes (see below) become active.
  - When the Master switch is clicked again, the gauge is set Off again.
  - Red: when Off.

(NOTE: all thresholds and Mode states are easily customiseable in the gauge)

1. Excessive descent rate.
- When aircraft above GPWS_UpperRALT (default: 900 ft):
  - When VerticalSpeed < -4000 ft/min:  "WhoopWhoopPullup"
  - When VerticalSpeed between -2500 and -4000 ft/min: "Sinkrate"
- When aircraft below GPWS_UpperRALT:
  - When VerticalSpeed < -2000 ft/min:  "WhoopWhoopPullup"
  - When VerticalSpeed between -1500 and -2000 ft/min: "Sinkrate"

2. Excessive terrain closure rate.
- Only entered when gear is up and flaps not in landing position.
- RadioAltitude decreasing: "TerrainTerrain"
- RadioAltitude < 250 ft AND decreasing:  "WhoopWhoopPullup"

3. Loss of altitude after takeoff
- RadioAltitude decreasing AND V/S > 0 ft/min: "TerrainTerrain"
- VerticalSpeed < 0 ft/min: "DontSink"

4. Insufficient terrain clearance.
- Gear is up AND flaps not in landing position: "TooLowTerrain"
- Gear is down AND flaps not in landing position: "TooLowFlaps"
- Gear is up AND flaps in landing position: "TooLowGear"

5. Excessive glideslope deviation.
- Only when gear is down, and flaps in landing position.
- Glideslope (in NAV1) is valid AND more then 1.5 dots below GS: "Glideslope"

6. Excessive banking.
- When the aircraft banks more then 35 degrees: "Bankangle"

7. Windshear.
- The longitudinal windspeed suddenly changes more then 15 knots:
  "WindshearWindshearWindshear"

8. Altitude callouts.
- RadioAltitude decreasing AND RadioAltitude passes heigth (x + y).
  - "x": R-ALT is: 10,20,30,40,50,100,200,300,400,500,1000,2500 or "Minimums".
  - "y": The basic R-ALT of the aircraft when on the ground (default: 18 feet)
  - "Minimums" callout: when the aircraft descends below the Decision Height
    (DH, see Notes) in landing configuration.

Notes:
- Modes 2,3,4,5,7 are only enabled when RadioAltitude is less then parameter
  "GPWS_UpperRALT" (default:900 ft).
  "RadioAltitude" as used in this gauge, is defined as the distance beween the
  earth surface and the gear in lowered position. 
- Modes 1,2,3,4,5,6 remain active while the condition remains.
  While active, the warning sounds of these modes are repeated every 4 sec.
  Also, only one of these modes will give an aural warning at the same time,
  with a priority from mode-1 (highest) to mode-6 (lowest).
  Note that the mode-7 and mode-8 aural warnings are independant of these !!
- When On, the gauge can be in TOGA mode or not:
  - TOGA mode is set (light Amber) when:
    - The aircrafts lifts off the ground at Takeoff or Touch&Go.
    - The gear is being raised when the aircraft is below "GPWS_UpperRALT"
      RadioAltitude (i.e. the GPWS assumes a GoAround).
    When set, modes 1,2,4,5 are disabled.
  - TOGA mode is reset when the aircraft is above "GPWS_UpperRALT"
    When reset, mode 2 is disabled.
  Besides this, the TOGA mode can be toggled manually by clicking the switch/light.
- "Minimums" callout.
  Unfortunately, "Decision Height" isn't very nicely implemented in FS2004, since
  it is maintained in Meters, and can only be in/decresed in multiple units of meters
  (not Feet).
  Probably because of this, most addon gauges that implement a changeable DH use
  their own, local variables and clickspots which are NOT accessable by my gauge.
  This means that if you change the DH in your current instrument that DOESN'T 
  use the standard FS2004 DH variables, you ALSO have to change the DH in my gauge
  (which does use/change the FS2004 variable) to a correct "Minimums" callout.
  I (like most addon designers) choose to ignore this peculiar DH behaviour, and
  just INTERPRETE the DH value in FS2004 in Feet, to get more realistic settings.
  The value of DH, as used for the "Minimums" callout, can be changed by clicking
  the "GPWS" text in my gauge, and can be in/decreased in steps of 10 feet. 
  The Tooltips give the current value in Feet.
- If your panel allready includes a gauge that partly overlaps with the 
  functionality of this gauge (like: altitude callouts): each one of the modes
  can be deactivated (= made permanentally invisible) individually by editing
  the startup state of that mode in the .xml file.
- This gauge can only be used in 2D-cockpit mode, since the VirtualCockpit
  is defined in the aircraft's .mdl file. Of course you can add it to a [VCockpit]
  window (e.g. with size 1,1), but then you won't be able to see/click the bitmap.
- When added to a 2D-Cockpit panel window, the gauge doesnot function before
  you have made that window visible at least ONCE after loading the aircraft.

Each of the GPWS modes has its own state and switch/light. See tooltips on the row
of eight switches/lights. 
These Mode states are:
0: Disabled. (= mode permanently invisible and inoperative)
1: Off (light Red).
   When clicked, the Mode state becomes On (state 4)
2: On/NoSound (light Off, with Red borders)
   The Mode is operational, but without aural warnings.
   This state is obsolete in V3.1
3: On/NoSound/Active (light Amber, with Red borders).
   The Mode conditions are true, and the amber warning light is On.
   When clicked, the sound is set On again (state 5).
   When the Mode conditions become False, the state becomes state 4.
   I.o.w.: the Sound is automatically enabled again.
4: On/NotActive (light Off).
   The Mode is operational, with aural warnings.
   When clicked, the Mode state is set Off (state 1)
   When the Mode conditions become True, the state changes to state 5.
5: On/Active (light Amber).
   The Mode conditions are true, the warning light is set and the aural warning is given.
   When clicked, the sound is set off (state 3).
   When the Mode conditions become False, the state changes to state 4.


The GPWS3_MasterWarn gauge: Detailed Functionality
==================================================
This gauge allows you to have a small gauge (MasterWarn) on the main panel (which
usually has little space left), while the main GPWS gauge is in another (or it's own)
panel window that need not always be visible.
Note however, that the main GPWS gauge window must be made visible at least ONCE 
after loading the aircraft, before the gauge is loaded !!

The gauge has a lighted switch, which is colored:
- OFF: no warning modes (1-6) are Active.
- RED: one or more warning modes (1-6) is Active with aural warnings.
- Flashing RED: one or more warning modes (1-6) is Active, but all aural warnings
  for these Active modes are disabled.
- Clicking the switch when RED, disables the aural warnings of the highest priority
  mode (=lowest number) currently Active. This means that the switch may stay RED,
  because another mode might be Active as well (and now give its aural warnings).
  If so, you have to click it again untill it's All Active modes have disabled sound.
  I.o.w.: by clicking a RED switch, you acknowledge the mode that currently gives
  an aural warning
- Clicking the switch when Flashing RED, enables all aural warnings again.
- When you ClickAndHold the switch, the gauge toggles a panel window with Ident=10051 
  This allows you to place the GPWS gauge in a seperate panel window, with window
  open/close control using the MasterWarn gauge.


HowTo customise the GPWS3.xml gauge
===================================
A lot of the gauge parameters can be adapted easily to your own preference or
specific aircraft, by editing the gauge with a simple text editor like Windows
Notepad. This specifically applies to parameters like:
- The base RadioAltitude of the aircraft when on the ground.
  This is determined by the aircrafts gearheight and datum position.
  Examples: 18 ft for a Boeing747, 3 ft for a Cessna.
  This parameter is only relevant for the accuracy of low-altitude callouts.
- The "landing position" flaps-setting of the aircraft.
  Obviously this can be different for every aircraft type, and depends on the
  number of flaps positions and flaps "degrees" per position. 
  Note: this limit is static, and doesnot take airspeed/weight into account.
  In this gauge, "landing position" is defined as any position where the 
  "flap handle" percentage is equal or more than the set threshold.
  You can determine this percentage (default: 64%) as follows:
  - Determine the number of flap positions of your aircraft.
    For each flap position, the "flaps handle position" is a lineair percentage.
    Example for a B747-400:
    - Has 7 flap positions: 0 1 5 10 20 25 30 degrees
    - Which corresponds with "flaps handle": 0 17 33 50 67 83 100 %
    - So for threshold at 64%, "flaps landing position" is "flaps 20" or more.
    Example for a B737-400:
    - Has 9 flap positions: 0 1 2 5 10 15 25 30 40 degrees
    - Which corresponds with "flaps handle": 0 12 25 37 50 62 75 87 100 %
    - So for threshold at 64%, "flaps landing position" is "flaps 25" or more.
- The descent rate threshold before a "Sinkrate" warning is giving. Obviously
  this value is different for a jetfighter and a small GA aircraft :-).
- Repetition/interval time of aural warnings.
- Startup state of the gauge (On or Off) when the gauge is loaded.
- The Modes that are supported by the gauge, and their startup state. 

Here's how to do this:
- In the panel folder of your aircraft, create a subfolder \rcb-gauges\.
  So you have a  folder:
    ...\Flight Simulator 9\Aircraft\"your aircraft"\panel\rcb-gauges\
- COPY the file GPWS3.xml from ..\gauges\rcb-gauges\ to this new folder.
- Now edit the GPWS3.xml file located in this new folder.

The effect is, that when FS2004 loads the gauge GPWS3.xml, it uses the one
in your ....\panel\rcb-gauges\, and NOT the original one in ..\gauges\rcb-gauges\

The same is true when you want to change (=re-color) the bitmaps
Note that the Background, SwitchOff and ModeS4 (mode Off) bitmaps have two
version: PanelOn (Panel light switch ON) and PanelOff.

Just make a copy of the .bmp(s) you want change in the new folder, and edit those.

In case you are in doubt what the parameters are: compare the default values
in the .xml file with those mentioned in section "Functionality" above.
Of course there are some logical restrictions on used values. Examples:
- GWPS_UpperAlt should always be higher then GWPS_LowerAlt.
- GWPS_LowerVS should always be more negative then GWPS_UpperVS.

!! NOTE for XML-gauge designers !!
The L:Var gauge parameters are initialised only at startup of the gauge; so you 
can adjust the default values realtime, by, from another XML-gauge,  forcing the
L:GPWS_* vars to another value. 
Or, change parameters in-flight, based on specific flight conditions.



Using the GPWS3_MasterWarn gauge: panel windows
===============================================
If you want to use the MasterWarn gauge, add to the main panel window:

gauge**=rcb-gauges!GPWS3_MasterWarn,HOR,VERT,13,13

and move the main (GPWS3) gauge definition to another panel window.

If you want to place the main GPWS3 gauge in its OWN panel window instead
of an existing one:

- Under [Window Titles], add the line:

Window**=GPWS

  where '**' is the next free number.

- Add the new window as:

[Window**]
size_mm=82,31
position=2    //Opens the window in the top-right corner of the screen.
visible=0
Ident=10060   //This ident is used MasterWarn to toggle this window on/off.
gauge00=rcb-gauges!GPWS3, 0,0,82,31



Copyrights and Disclaimer
============================
This package is freeware (NOT: public domain), and is available for your
personal use only.

Without my explicite permission, it may NOT be sold, re-distributed and/or 
uploaded to another website or bulletin board in ANY shape or form.
If you want to bundle this package with your (freeware) aircraft, you may ONLY
do so AFTER my explicite permission and inclusion of the documentation file.

And obviously, installing & using this package is at your own risk. 
However, if you execute the Installation instructions properly, this package
should NOT crash you PC or FS, nor should it have a substantial impact on 
performance. 
Although most of the testing was done on Windows-XP platforms, I don't expect
any problems with other Windows versions (provided FS2004 itself runs OK).


Credits
=======
- Doug Dawson, for his great gauge that allows playing sounds from an XML gauge.
  This gauge (dsd_xml_sound3.gau) is included in this package, and renamed as
  GPWS_Sound.gau, to avoid possible future incompatibilities.
- Most of the callouts/warnings are modified versions of existing soundfiles, 
  but I was unable to establish their exact origin. I think some originated from
  the FPDA group, and some from Tom Corson. If you recognise them as yours, 
  please inform me so I can give you proper credit.


As with all of my gauges, I'm always open for questions, or suggestions for
improvement. But PLEASE !!, read this manual properly before mailing me.

Enjoy, and fly safe .....

Rob Barendregt, The Netherlands
Email: rc.barendregt@planet.nl


***************************** End Of Readme ********************************

